This document contains important information about tn3270 distribution files. Please read the following carefully before using the files you have received.
Configuration notes:
1. If you are using tn3270 on a Macintosh II under MultiFinder, be sure to set the memory size for tn3270 according to the directions in section "MultiFinder and Memory Requirements" in the documentation. The memory size in the distributed version of tn3270 will NOT work well with a Macintosh II and MultiFinder, and may even crash the Mac. To change the memory size, while running Finder click on the program and select "Get Info" from the "File" menu. Then change the value shown for "Application Memory Size". Starting with version 6.0 of the Macintosh System Software, MultiFinder may also be used to change the memory size.
2. Configuration has changed from the method described in the documentation (tn3270 refguide). Configuration is now identical to version 2.3 of NCSA Telnet, with the same config.tel and NCSA Telnet Settings files being used. Refer to NCSA's documentation (NCSA Teln.8) for directions on defining those files. Briefly, configuration is performed by (1) editing config.tel to reflect the proper keyword values, and (2) holding down the mouse button after double-clicking on tn3270 the first time. This will cause tn3270 to prompt for configuration information, and create a new NCSA Telnet Settings file. These steps are not necessary if you have already created these files using NCSA Telnet.
3. For your convenience, the Documentation folder includes two chapters from the NCSA Telnet documentation which are also applicable to tn3270. These chapters describe FTP file transfer and configuration. Be careful, since some of the information does NOT apply to tn3270. This documentation will be edited before the release version of tn3270 2.3.
4. There are no known bugs when using this version of tn3270 with System 7.0. Please report any bugs you discover using tn3270 with System 7.0.
Description of distribution files:
2.3d26 Folder:
tn3270
The NCSA version of the tn3270 application.
config.tel
Sample configuration file for LocalTalk connections.
config.tel.ether
Sample configuration file for Ethernet connections.
Mac Plus/SE
B&W Mac II Family
Color Mac II Family
Sample tn3270 settings files. These files contain suggested settings for different models, depending on the displays they have. These file differ only in the highlighting and color settings. They are NOT needed to tell tn3270 which model it is running on.
2.3d26 MacTCP Folder:
tn3270
The MacTCP version of the tn3270 application.
config.tel
Sample configuration file for use with MacTCP.
Mac Plus/SE
B&W Mac II Family
Color Mac II Family
Sample tn3270 settings files. These files contain suggested settings for different models, depending on the displays they have. These file differ only in the highlighting and color settings. They are NOT needed to tell tn3270 which model it is running on.
Documentation Folder:
tn3270 refguide
Reference guide for tn3270 version 2.0. The information in this document is still correct, except for the changes listed in "changes 2.3d26".
changes 2.3d26
Lists the changes to tn3270 since the first release, 2.0.
tn3270 bugs23
Lists known bugs in the current version of tn3270.
Brown tn3270 docs
tn3270 documentation prepared for local users at Brown, including an updated copy of the Reference Guide. See the enclosed "read-me" file for more information.
NCSA Teln.5
Chapter 5 of the NCSA Telnet documentation. This chapter describes file transfer using FTP. Most of the information in it also applies to tn3270. For floppy disk distribution, this file is included in the StuffIt archive file "NCSA doc.sea" in order to save space.
NCSA Teln.8
Chapter 8 of the NCSA Telnet documentation. This chapter contains system administrator information. Most of the information also applies to tn3270. For floppy disk distribution, this file is included in the StuffIt archive file "NCSA doc.sea" in order to save space.
Network Configuration Folder:
newh
An awk script provided by NCSA for converting UNIX /etc/hosts files into the format used in config.tel.
telpass
An application from NCSA for defining FTP password protection.
Keyboard Configuration Folder:
KeyMap
An application for adding and replacing keyboard mappings in tn3270.
KeyMap doc
Documentation for using KeyMap in TeachText format.
default.kbmap
Definition file for KeyMap of the "default" definition in tn3270.
numeric.kbmap
Definition file for KeyMap of the "numeric keypad" definition in tn3270.
ala.kbmap
Definition file for KeyMap of the "ala" definition in tn3270. This is intended to be used with the ALA character set in the "National Language" menu. It matches the mapping used on the IBM 3163 and 3164 terminals with the ALA RPQ installed, when used with a Macintosh Extended Keyboard.
deutsch.kbmap
Definition file for use with German Macintosh keyboards. This file is an example of how keyboard mappings can be made for national languages. It is intended to be used with the "Austrian/German" character set in the "National Language" menu.
Goodies Folder:
This folder contains various files which are not a formal part of the tn3270 distribution package, but which some tn3270 users may find useful:
beep sounds: additional beep sounds to use with tn3270 or in your system
español: files to customize tn3270 for Spanish, including the Catalan characters
tn3270 API Folder:
This file contains files for using the Application Program Interface in tn3270. See the file "Read Me First" in this folder for more information.